home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 January: Technology Seed / Jan. '98 ATS.toast / NavServices1.0b3 / Navigation Services SDK / Documentation / Navigation Services Read Me next >
Encoding:
Text File  |  1998-01-12  |  2.3 KB  |  46 lines  |  [ttro/ttxt]
  1. Navigation Services SDK Read Me
  2.  
  3. Welcome to Navigation Services!
  4. The Navigation Services suite greatly enhances the user experience of opening, saving and selecting documents, while giving your application new capabilities without customizing dialogs.
  5.  
  6. Navigation Services is a new set of APIs to:
  7. - open and save documents
  8. - confirm save / discard changes
  9. - select a file, folder or volume
  10. - create a new folder
  11.  
  12. Some of the benefits of adopting Navigation Services APIs for your application include:
  13. - new movable, resizable, Appearance-aware Open & Save dialogs
  14. - easier navigation: list view with disclosure triangles, recent items, favorite items, etc
  15. - built-in file format translation
  16. - use of this API will allow Apple to transparently deliver new features in future versions of the System Software.
  17.  
  18. More information on the features of the new dialogs and API may be found in the Navigation Services developer note.
  19.  
  20. Building with Navigation Services
  21.  
  22. Navigation Services is released as a fat CFM shared library. It can be used to build PowerPC applications as well as 68K applications, using CFM-68K or classic 68K runtime models.
  23.  
  24. To use Navigation Services in your application:
  25.  
  26. Include the file "Navigation.h" in your project.  To build with Navigation.h you should use the Universal Headers 3.0.  Universal Headers 3.0 can be downloaded for free from Apple's Devworld site (http://devworld.apple.com/dev/).  We encourage you to upgrade to Universal Headers 3.0.  If, however, upgrading them is not a possibility, include the following statements in your precompiled header file:
  27.  
  28. #define CALLBACK_API(_type, _name)                pascal _type (*_name)
  29. #define EXTERN_API(_type)                extern pascal _type
  30. #define STACK_UPP_TYPE(name)                name
  31.  
  32. This will allow for compatibility between your current project's Universal Headers and Navigation.h.
  33.  
  34. Then link with:
  35. - for PowerPC/CFM-68K: NavigationLib
  36. - for Classic 68K: Navigation.o or Navigation.far.o
  37.  
  38. On 68K systems, replace the OpenTransportLib.68k in your Extensions folder with the one included in this SDK.
  39.  
  40. To use Navigation Services, make sure that the Navigation shared library is installed in the Extensions folder of your machine.
  41.  
  42. For sample code, refer to the SimpleText or Sampler application folders found in the SDK.
  43.  
  44. Depencencies
  45.  
  46. When using Navigation Services, be sure your system is version 7.5.5 or later running Appearance 1.0.1.